home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / utils2 / tbt323.arj / TURBOBAT.MAN < prev    next >
Text File  |  1994-04-11  |  38KB  |  1,151 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. ExtraDOS Toolbox (tm)
  10. _______________________________________
  11.  
  12.   Users Manual
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33. Copyright (c) 1985-93 Foley Hi-Tech Systems (ASP)  All Rights Reserved
  34.  
  35.  
  36. Introduction
  37. _____________________________________________________________________
  38.  
  39.  
  40. ExtraDOS Toolbox is a compilation of tools useful to Microsoft DOS
  41. users.  I originally wrote the first version of ExtraDOS under MS-DOS
  42. because I found a need for them and there were no commercially
  43. available products that provided these functions.  Some ExtraDOS tools
  44. were designed to enhance programs already found in MS-DOS.  Other
  45. tools were familiar to the Unix world, but were not available in
  46. MS-DOS.  Over the years this collection has grown into large group of
  47. very useful tools.  Some of these utilities are duplicates of those
  48. found elsewhere, but often provide much better features or reduced
  49. memory overhead than similar utilities found elsewhere.  In addition,
  50. ExtraDOS complements PC-Tools and Norton Utilities with added tools
  51. these programs do not provide.
  52.  
  53. Over thirty of the ExtraDOS Toolbox utilities have been selected by
  54. Paul Somerson, former Executive Editor of PC Magazine, for Bantam
  55. Books', DOS Power Tools, 2nd Edition, Revised and Expanded for DOS
  56. 5.0.  Many of the ExtraDOS Toolbox utilities are now appearing in many
  57. popular DOS books that feature shareware enhancements for DOS.
  58.  
  59. I hope you find these tools useful and convienent.  Any suggestions
  60. for enhancements, improvements or additions are welcome.  Please
  61. contact use with your comments.
  62.  
  63.  
  64. David R. Foley
  65.  
  66.  
  67. License Agreement
  68. _____________________________________________________________________
  69.  
  70.  
  71.   This software is protected by both United States' copyright law and
  72.   international treaty provisions. Therefore, you must treat this
  73.   software "just like a book," with the following single exception.
  74.   Foley Hi-Tech Systems authorizes you to make archival copies of the
  75.   software for the sole purpose of backing up our software and
  76.   protecting your investment from loss. By saying, "just like a book,"
  77.   Foley Hi-Tech Systems means that this software may be used by any
  78.   number of people and may be freely moved from one computer location
  79.   to another, provided there is absolutely no possibility of it being
  80.   used at one location while it is being used at another. Just as a
  81.   book cannot be read by two different people in two different places
  82.   simultaneously, the software may not be used by two different people
  83.   in two different places simultaneously.
  84.  
  85.   You may not make copies of the software documentation or disk,
  86.   except as described above. You may not distribute, rent, sublicense,
  87.   or lease the software or the documentation. You may not alter,
  88.   modify, or adapt the software or documentation, including but not
  89.   limited to translating, decompiling, reverse assembling, or creating
  90.   derivative works. You may not use the software in a network,
  91.   timeshareing, multiple CPU, or multi- user environment unless each
  92.   user is licensed by Foley Hi-Tech Systems.
  93.  
  94.  
  95. EXTRADOS TOOLBOX
  96. _____________________________________________________________________
  97.  
  98.  
  99. LIMITED WARRANTY
  100.  
  101.   Upon notification of defects in material or workmanship,
  102.   within the warranty period of 45 days from the date of purchase,
  103.   Foley Hi-Tech Systems will, at its option, replace the defective
  104.   diskette or refund the license fee. If you need to return a product,
  105.   call the Foley Hi-Tech Systems Technical Support Service Department
  106.   to obtain a return authorization number. The remedy for breach of
  107.   this warranty shall be limited to replacement or refund and shall
  108.   not encompass any other damages, including but not limited to loss
  109.   of profit, and special, incidental, consequential, or other similar
  110.   claims.
  111.  
  112.   Foley Hi-Tech Systems specifically disclaims all other warranties,
  113.   expressed or implied, including but not limited to implied
  114.   warranties of merchantability and fitness for a particular purpose
  115.   with respect to defects in the diskette and documentation, and the
  116.   program license granted herein in particular, and without limiting
  117.   operation of the program license with respect to any particular
  118.   application, use, or purpose. In no event shall Foley Hi-Tech
  119.   Systems be liable for any loss of profit or any other commercial
  120.   damage, including but not limited to special, incidental,
  121.   consequential, or other damages. This statement shall be construed,
  122.   interpreted, and governed by the laws of the State of California.
  123.  
  124.  
  125. TRADEMARK INFORMATION
  126.  
  127.   ExtraDOS Toolbox, TurboBAT, SpeedRAM, Screen Manager, Profiler,
  128.   WizLabel, CDBS, Press Gate Manager, ExtraWindows Toolbox and Safety
  129.   Disk are trademarks of Foley Hi-Tech Systems.
  130.  
  131.   MS-DOS and Windows are trademarks of Microsoft Corporation.
  132.  
  133.   Norton Utilities are a trademark of Symantec.
  134.  
  135.   PC-Tools is a trademark of Central Point Software.
  136.  
  137. TURBOBAT - Turbo Batch File Compiler
  138. _____________________________________________________________________
  139.  
  140.  
  141. DESCRIPTION
  142.  
  143.   TurboBAT allows you to compile standard DOS batch files into .COM
  144.   binary programs.  This will greatly enhance the speed of large batch
  145.   files by allowing them to run in native code rather than interpreted
  146.   DOS commands. The resulting .COM files may call nested batch files
  147.   without loosing the parent since the parent calling program is now
  148.   no longer a batch file.
  149.  
  150.  
  151. COMMAND FORMAT
  152.  
  153.  
  154.   TURBOBAT [/1][/4][/A][/Dname][/I][/L][/T][/X] file[.ext]
  155.  
  156.   /1      Insert single stepping code.  The creates a version of the
  157.           output that is useful when debugging a batch file.  When the
  158.           output .COM program is run, it will single step through each
  159.           line of the original program.
  160.  
  161.   /4      Supress 4DOS warning messages.  Don't report any warning
  162.           messages generated by the use of 4DOS specific commands.
  163.  
  164.   /A      Supress all warning messges (same as /4/I/L/X).  Don't
  165.           display any warning messages, only error messages.
  166.  
  167.   /Dname  Include full symbolic tracing information.  If NAME is
  168.           specified the information will be sent to the named file,
  169.           otherwise is is displayed via the standard error device.
  170.           There must not be any spaces between /D and NAME.
  171.  
  172.   /I      Ignore nonstandard labels.  DOS supports labels up to 8
  173.           characters long for use with the goto statement.  Many
  174.           people use the label as a comment field rather than a label
  175.           and this can cause problems when a label that is used in a
  176.           non standard fashion shows up during the compile stage of
  177.           the batch file. DOS will noramally just ignore this error.
  178.  
  179.   /L      Relaxed label length checking.  The normal label size
  180.           recognized by DOS is 8 characters.  In many cases people use
  181.           the : as a place holder for the program without ever
  182.           referencing the label. The problem is that if you have more
  183.           than one long label name where the first 8 digits match
  184.           another label, the file won't compile because it will look
  185.           as though you have duplicate labels.  This switch relaxes
  186.           that limit.
  187.  
  188.   /T      Compile with line number TRACE information.  The line number
  189.           information is displayed via the standard error device.
  190.           When running the output program compiled with this option on
  191.           you will get a display of each line number as the program is
  192.           running. This is useful when trying to determine where a
  193.           program is failing.
  194.  
  195.  
  196. TURBOBAT - Turbo Batch File Compiler
  197. _____________________________________________________________________
  198.  
  199.   /X      Supress extension warning messages.  Normally during
  200.           compilation, TurboBAT will warn you about any lines that
  201.           make use of commands that are supported by the compiler but
  202.           are not supported by DOS. Using the /X will tell TurobBAT
  203.           not to warn you about any BATCH files that will not function
  204.           under normal DOS conditions.
  205.  
  206.   /B-     Use ANSI escape sequences instead of the BIOS.  The default
  207.           screen I/O is now handled by making calls to the video BIOS.
  208.           This insures that the compiled batch file will work on any
  209.           machine with or without ANSI.SYS installed.  The drawback
  210.           to this is that BIOS calls are much slower than ANSI calls.
  211.           If you know that the machine that will be running the
  212.           compiled program then using the /B- command will speed up
  213.           the video calls.
  214.  
  215.  
  216. NOTES
  217.  
  218.   TurboBAT is a multipass batch file compiler.  It takes interpreted
  219.   DOS batch files and turns them into binary programs that can execute
  220.   up to as much as 4 times faster than normal batch files.  While
  221.   supporting most of the normal DOS functions that can be called from
  222.   within a batch file, TurboBAT also provides many additional features
  223.   including support for many 4DOS/NDOS commands.
  224.  
  225. WARNING !!!!
  226.  
  227.   From a compiled batch file, do not execute any programs that will
  228.   remain resident in memory when it terminates.  Doing so can result
  229.   in an unstable system, requiring you to reboot your computer.
  230.  
  231. EXTENDED BATCH COMMANDS
  232.  
  233.   TurboBAT support many commands beyond those supported in normal
  234.   batch files. Some of these commands are in support of J.P. Softwares
  235.   4DOS Batch Enhancements and others are to replace small external DOS
  236.   utilities.
  237.  
  238. THE ENVIRONMENT
  239.  
  240.   Initially, a compiled batch file will retrieve information from its
  241.   local environment.  However, when a command such as SET is used
  242.   which modifies the environment the compiled batch file will
  243.   use the system's master environment.  If a compiled batch file
  244.   that does not modify the environment executes another compiled
  245.   batch file or program that does modify the environment, it will
  246.   return incorrect results.  The fix is very simple, simply add a
  247.   line near the start of the main batch file that modifies the
  248.   environment, e.g.:
  249.  
  250.                  UNSET DUMMY
  251.  
  252.  
  253. TURBOBAT - Turbo Batch File Compiler
  254. _____________________________________________________________________
  255.  
  256.  
  257. INTERNALLY SUPPORTED COMMANDS
  258.  
  259.  
  260.   DOS Commands and batch file commands that are directly supported by
  261.   TurboBAT and require no external programs are:
  262.  
  263.  
  264.   %?     "Internal" evironment variable.  Expands to the error level
  265.          of the last executed program as a string.
  266.  
  267.          Example:  SET LASTERROR=%?
  268.  
  269.  
  270.   BEEP   BEEP [frequency duration ...]
  271.  
  272.          Sounds a tone of the specified frequency for the duration in
  273.          clock ticks.  The defaults are 440Hz (A below middle C) for 2
  274.          clock ticks (about 1/4 second).
  275.  
  276.          The list of tones and durations can be repeated on a single
  277.          line. This table is identical to the 4DOS tone table:
  278.  
  279.           ╔════════╦═══════╤═══════╤═══════╤════════╤═══════╗
  280.           ║ C      ║  131  │  262  │  523  │  1040  │  2093 ║
  281.           ║ C#/Db  ║  139  │  277  │  554  │  1103  │  2217 ║
  282.           ║ D      ║  147  │  294  │  587  │  1176  │  2349 ║
  283.           ║ D#/Eb  ║  156  │  311  │  622  │  1241  │  2489 ║
  284.           ║ E      ║  165  │  330  │  659  │  1311  │  2637 ║
  285.           ║ F      ║  175  │  349  │  698  │  1391  │  2794 ║
  286.           ║ F#/Gb  ║  185  │  370  │  740  │  1488  │  2960 ║
  287.           ║ G      ║  196  │  392  │  784  │  1568  │  3136 ║
  288.           ║ G#/Ab  ║  208  │  415  │  831  │  1662  │  3322 ║
  289.           ║ A      ║  220  │  440  │  880  │  1760  │  3520 ║
  290.           ║ A#/Bb  ║  233  │  466  │  932  │  1866  │  3729 ║
  291.           ║ B      ║  248  │  494  │  988  │  1973  │  3951 ║
  292.           ╚════════╩═══════╧═══════╧═══════╧════════╧═══════╝
  293.  
  294.  
  295.   BOOT   BOOT [WARM | COLD]
  296.  
  297.          Boots the computer.  If no options are specified or if WARM
  298.          is specified a WARM boot will occur.  If COLD is specified
  299.          the computer will go through the entire cold boot process.
  300.          Under Desqview, a warm boot will only close the window.
  301.  
  302.   CDD    CDD drive:path
  303.  
  304.          Changes subdirectories and drives.  This command will change
  305.          the current directory and drive to the one specified in
  306.          [drive:path] and make the current DOS drive equal to the
  307.          value in [drive]. Normally within dos the CD command will
  308.          change directories on any drive that you specify but will
  309.          keep the current drive the same. CDD allows you to switch to
  310.          that drive rather than stay on the current drive.
  311.  
  312. TURBOBAT - Turbo Batch File Compiler
  313. _____________________________________________________________________
  314.  
  315.  
  316.   CHDIR/CD  CD path
  317.             CD drive:path
  318.  
  319.             Change the current directory as specified in path.  If a
  320.             drive is specified than change the current directory of
  321.             that drive to the directory specified in path.
  322.  
  323.   CLS       CLS [[bright] [blink] fg on bg]
  324.  
  325.             Clears the screen and optionally sets the screen color.
  326.             When setting the colors the syntax is identical to the
  327.             COLOR command.
  328.  
  329.   COLOR     COLOR [bright] [blink] fg ON bg
  330.  
  331.             Uses ANSI escape squences to set the screen color. Only
  332.             the first three letters of each command word are actually
  333.             significant.  The following colors are allowed:
  334.  
  335.               BLAck     BLUe      GREen     RED
  336.               MAGenta   CYAn      YELlow    WHIte
  337.  
  338.             Example:  COLOR BRIGHT WHITE ON BLUE
  339.  
  340.  
  341.   DELAY     DELAY [seconds]
  342.  
  343.             Pauses for the specified interval in seconds.  If no
  344.             duration is given it will pause for 1 second.
  345.  
  346.  
  347.  
  348.   ECHO      ECHO [message]
  349.  
  350.             If the /D switch was used at compile time you can enable
  351.             or disable command echoing with ECHO OFF and ECHO ON.
  352.             ECHO without any text will indicate if the /D switch was
  353.             used when the file was compiled, not the current status of
  354.             command echoing. To display a blank line use "ECHO:" or
  355.             "ECHO.".
  356.  
  357.  
  358. TURBOBAT - Turbo Batch File Compiler
  359. _____________________________________________________________________
  360.  
  361.   ECHOS     ECHOS [message]
  362.  
  363.             Displays the message without appending a cr/lf to the end
  364.             of the message like ECHO does.  (used to be ECHONLN but was
  365.             updated to match the 4DOS command.
  366.  
  367.  
  368.   ELSE      If the IFF condition was false the lines from ELSE to
  369.             ENDIFF will be executed.
  370.  
  371.             See Also IFF.
  372.  
  373.  
  374.   ELSEIFF   ELSEIFF condition [THEN]
  375.  
  376.             Similar structure to the IFF command. If the previous IFF
  377.             was false and the current condition is true the code
  378.             following will be executed to the next ELSE, ELSEIFF, or
  379.             ENDIFF statement.  Each use of ELSEIFF counts as a nesting
  380.             level.  The compiler actually converts this command into
  381.             logical ELSE^IFF^ENDIFF statements.
  382.  
  383.             See Also IFF.
  384.  
  385.   ENDIFF    Terminates an IFF statement.
  386.  
  387.             See Also IFF.
  388.  
  389.  
  390.   EXIT      EXIT is used when at the DOS level if you are running
  391.             within a shelled version of the command interpretor and
  392.             you wish to exit the shelled session.  The EXIT command is
  393.             ignored by TurboBAT. See also QUIT.
  394.  
  395.  
  396.   FOR       FOR %%var IN (file list) [DO] command
  397.  
  398.             Allows more than a single letter as the loop variable. Can
  399.             be nested.  The loop variable can be tested from other
  400.             lines by treating it as a normal environment variable.
  401.             The word "DO" is required by DOS but is optional under
  402.             4DOS and Turbobat.
  403.  
  404.  
  405. TURBOBAT - Turbo Batch File Compiler
  406. _____________________________________________________________________
  407.  
  408.   GOTO   GOTO label
  409.  
  410.          Will jump control to the label.  Labels are marked as a line
  411.          begining with a :.
  412.  
  413.  
  414.   GOSUB  GOSUB label
  415.  
  416.          Calls a label in the current batch file as a subroutine. Must
  417.          have a matching RETURN statement. The end of the batch file
  418.          does NOT act as a RETURN.
  419.  
  420.  
  421.   IF     IF [NOT] first (== | EQ | NE | LT | LE | GT | GE) second command
  422.          IF [NOT] ERRORLEVEL [== | EQ | NE | LT |LE | GT | GE] value command
  423.          IF [NOT] ENVFREE [== | EQ | NE | LT |LE | GT | GE] value command
  424.          IF [NOT] EXIST filename command.
  425.          IF [NOT] ISDIR path command
  426.  
  427.          EQ (equal), also '==' and '='
  428.          NE (not equal),
  429.          LT (less than),
  430.          LE (less or equal),
  431.          GT (greater than),
  432.          GE (greater or equal).
  433.  
  434.          If no compare command is used for ERRORLEVEL or ENVFREE the
  435.          default of GE will be used.
  436.  
  437.          EXIST tests for the existence of a file.
  438.  
  439.             IF EXIST my.cfg GOTO continue
  440.             ECHO Configuration file is missing
  441.             QUIT 99
  442.             :continue
  443.  
  444.          ISDIR tests if the given path specification is an existing
  445.          subdirectory.
  446.  
  447.             IF NOT ISDIR \work MD \work
  448.  
  449.          ENVFREE tests the available environment space.
  450.  
  451.             IF ENVFREE LT 123 ECHO Insufficient environment space
  452.  
  453.  
  454.  
  455. TURBOBAT - Turbo Batch File Compiler
  456. ___________________________________________________________
  457.  
  458.  
  459.   IFF    IFF condition [THEN]
  460.  
  461.          If the condition is true the lines up to ELSE, ELSEIFF or
  462.          ENDIFF (whichever appears first) will be executed. IFF
  463.          statements may be nested up to 15 levels deep.  See also IF.
  464.  
  465.                 IFF %? EQ 0 THEN
  466.                   GOTO CONTINE
  467.                 ELSEIFF %? EQ 99
  468.                   THEN GOTO CRITICAL
  469.                 ELSE
  470.                   GOTO ERROR
  471.                 ENDIFF
  472.  
  473.  
  474.   INKEY  INKEY [/Wn] [message] %%var
  475.  
  476.          Gets a single keystroke and places it in the environment.
  477.          %%var is the environment variable that will be assigned the
  478.          keystroke. If /W is specified the command will wait up to
  479.          that many seconds, e.g. /W10. It will also optionally display
  480.          a message.  If a wait of zero is used (/W0) the command will
  481.          return immediately if no keystrokes are pending.  The wait
  482.          period can be specified in the environment, but the /W but be
  483.          present on the line at compile time, e.g.:
  484.  
  485.              inkey /w%delay Press any key: %%key
  486.  
  487.          Displayable keystrokes (characters above the space) are
  488.          stored as their corresponding character.  Keystrokes that do
  489.          not have a corresponding character are displayed as a number,
  490.          e,g. the carriage return as "13".  Extended keystrokes such
  491.          as F1 are stored with a preceding '@', (@59 for F1).
  492.  
  493.  
  494.   INPUT  INPUT [/Wn] [message] %%var
  495.  
  496.          Gets a string and places it in the environment.  %%var is the
  497.          environment variable that will be assigned the string.  The
  498.          string is terminated by a carriage return or end of file mark
  499.          (^Z).  Extended keystrokes are ignored.  /Wn is the optional
  500.          maximum time in seconds to wait for the first keystroke.
  501.          Once a keystroke is entered this command will not time out.
  502.  
  503.   MKDIR  MKDIR [pathname]
  504.   MD     MD [pathname]
  505.  
  506.          Will create a new directory of PATHNAME.
  507.  
  508.  
  509.   PATH   Displays or Sets the Path.
  510.  
  511.  
  512. TURBOBAT - Turbo Batch File Compiler
  513. ___________________________________________________________
  514.  
  515.  
  516.  
  517.   PAUSE   PAUSE [message]
  518.  
  519.           Displays an optional message.  If no message is specified the
  520.           default of "Press a key when ready..." is used.  In addition,
  521.           a CR/LF is not output until after the key is pressed.
  522.  
  523.  
  524.   PROMPT  Displays or Sets the DOS Prompt
  525.  
  526.  
  527.   QUIT    QUIT [exitcode]
  528.  
  529.           Unconditionally halts the compiled batch file.  If no
  530.           exitcode is specified, zero will be used.  The exit code can
  531.           refer to an environment variable.  If the variable is not a
  532.           number or does not exist zero will be used.  Examples:
  533.  
  534.                 SET var=1
  535.                 QUIT %var
  536.  
  537.           Exits with 1.
  538.  
  539.                 SET var=test
  540.                 QUIT %var
  541.  
  542.           Exits with 0 because %var is not a number.
  543.  
  544.  
  545.   REM     REM is the standard DOS Remark field.  REM lines are ignored
  546.           by the TurboBAT Compiler.
  547.  
  548.  
  549.   REPEAT/
  550.   UNTIL   Similar to the Pascal structure.  May be nested up to 15
  551.           deep. Redirection is not allowed on a line containing REPEAT
  552.           or UNTIL.
  553.  
  554.                 REPEAT
  555.                   ECHO %1
  556.                   SHIFT
  557.                 UNTIL "%1" EQ ""
  558.  
  559.  
  560.   RETURN  Return from a subroutine call.  If no subroutines are
  561.           pending it will terminate the batch file with an exit code of 255.
  562.  
  563.   RD
  564.   RMDIR   Remove Directory.  This will remove the directory specified
  565.           as long as there are no files in it.
  566.  
  567.  
  568.  
  569.  
  570. TURBOBAT - Turbo Batch File Compiler
  571. _____________________________________________________________________
  572.  
  573.  
  574.   SCREEN  SCREEN row column [message]
  575.  
  576.           Positions the cursor using ANSI sequences and displays an
  577.           (optional) message.  The cursor coordinates are 0 based, the
  578.           normal range being 0-24 rows and 0-79 columns.
  579.  
  580.  
  581.   SCRPUT  SCRPUT row col [bright][blink] fg ON bg message
  582.  
  583.           Writes the message at the specified screen coordinates using
  584.           the specified colors.  The cursor position is restored to
  585.           the position before the command.  ANSI escape sequences are
  586.           used throughout.
  587.  
  588.   SET     Alone, Set will display the current environment variables,
  589.           or followed by an environment variable, set will set the
  590.           environment variable to the given value.
  591.  
  592.  
  593.   SHIFT   Same as standard DOS.  I will be expanding this command for
  594.           4DOS compatibility to accept a shift factor, with support
  595.           for a negative number which will get back previously shifted
  596.           parameters.
  597.  
  598.   SINGLESTEP    SINGLESTEP ON | OFF
  599.  
  600.           Enables or disables single stepping.  The /1 compiler switch
  601.           must be used for this command to have any effect.  The
  602.           options are resolved at compile time so you can not use an
  603.           environment variable or command line parameter to set the
  604.           status.
  605.  
  606.  
  607.  
  608.   TEXT/
  609.   ENDTEXT The text that follows, up to ENDIFF will be displayed as if
  610.           each line was preceded by an ECHO. Output redirection is
  611.           more efficient using this command instead of individually
  612.           redirected ECHO commands since the file will only be opened
  613.           and closed once, while the file will be opened and closed
  614.           for each ECHO command.
  615.  
  616.                 TEXT
  617.                 This could be a menu
  618.                 or it could be help information
  619.                 ENDTEXT
  620.  
  621.                 TEXT >dummy
  622.                 This text will be sent to the redirection file.
  623.                 Up to, but not including the ENDTEXT command.
  624.                 ENDTEXT
  625.  
  626.  
  627.  
  628. TURBOBAT - Turbo Batch File Compiler
  629. _____________________________________________________________________
  630.  
  631.  
  632.   UNSET   Deletes the environment variable from the master environment.
  633.  
  634.                 UNSET RESULT
  635.  
  636.  
  637.   WHILE/
  638.   WEND    Similar to the Pascal structure. May be nested up to 15
  639.           deep. Redirection is not allowed on a line containing WHILE
  640.           or WEND.
  641.  
  642.                 WHILE "%1" NE ""
  643.                   ECHO %1
  644.                   SHIFT
  645.                 WEND
  646.  
  647.  
  648.  
  649.  
  650.  
  651. COMMANDS HANDLED BY CALLING THE COMSPEC
  652.  
  653.  
  654.   These commands are supported by calling COMMAND.COM:
  655.  
  656.   CALL, DIR, DEL, REN, VER, VOL, CTTY, CHCP, TYPE, COPY, DATE, TIME,
  657.   ERASE, BREAK, RENAME, DELETE, VERIFY, COMMAND
  658.  
  659.  
  660.   These commands will only work if 4DOS is the active COMSPEC:
  661.  
  662.   FREE, DRAWBOX, DRAWHLINE, DRAWVLINE, MEMORY
  663.  
  664.  
  665.  
  666. TURBOBAT - Turbo Batch File Compiler
  667. _____________________________________________________________________
  668.  
  669. COMPILER ERROR MESSAGES
  670.  
  671.   TurboBat contains a library of internal error messages and will
  672.   display the error number and message when an error or warning is
  673.   found.  Files with just warnings will compile, files with errors
  674.   will not compile.
  675.  
  676.   Warning Messages / Error Messages
  677.  
  678.    1  Duplicate label
  679.  
  680.       Each label must be unique for a file to compile correctly.  Use
  681.       the /I to relax label checking when using the : for marking
  682.       comments.
  683.  
  684.  
  685.    2  Duplicate label (check size)
  686.  
  687.       Sometimes labels are used as comments in batch files.  If a
  688.       label is unique, but after the 8th character the compiler won't
  689.       pick it up as unique since DOS only supports the first 8
  690.       characters of a label.  You can use the /L option to relax label
  691.       length checking.
  692.  
  693.  
  694.    3  Redirection not allowed here
  695.  
  696.       TurboBAT does not support the redirection of output or input at
  697.       the location specified.
  698.  
  699.  
  700.    4  Invalid IF statement
  701.  
  702.       The IF statement is using invalid syntax, check the manual for
  703.       usage of IF and IFF commands.
  704.  
  705.  
  706.    6  Invalid FOR statement
  707.  
  708.       The FOR statement is using invalid syntax, check the manual for
  709.       the usage of the FOR command.
  710.  
  711.  
  712.    7  EXIT can not be used in a compiled batch file
  713.  
  714.       EXIT is normally used to abort a batch file at any location.
  715.       You can not do this with a compiled batch file.  Replace usage
  716.       of EXIT with a GOTO command that jumps to a label at the end of
  717.       the batch file.
  718.  
  719.    8  Label not Found.
  720.  
  721.       A reference was made to a label that does not exist.
  722.  
  723.  
  724. TURBOBAT - Turbo Batch File Compiler
  725. _____________________________________________________________________
  726.    9  Program is too large
  727.  
  728.       The output of the compiled batch file is exceeding 64k bytes.
  729.       TurboBAT currently only supports the .COM format of programs
  730.       under 64k bytes large.  Reduce the commands in your batch file
  731.       if possible.
  732.  
  733.  
  734.   10  REPEAT nested too deeply
  735.  
  736.       You have too many levels of nesting with a REPEAT Loop.  Try
  737.       breaking the repeat loop out of a nested piece of code.
  738.  
  739.  
  740.   11  Unmatched UNTIL
  741.  
  742.       The UNTIL statement found has no opening REPEAT command.
  743.  
  744.  
  745.   12  WHILE nested too deeply
  746.  
  747.       You have too many levels of nesting with a WHILE Loop.  Try
  748.       breaking the while loop out of a nested piece of code.
  749.  
  750.  
  751.   13  Unmatched WEND
  752.  
  753.       The WEND statement found has no opening WHILE command.
  754.  
  755.  
  756.   14  Label longer than nn characters, truncated
  757.  
  758.       Labels that are longer than supported by TurboBAT will be
  759.       truncated to the maximum characters allowed.
  760.  
  761.  
  762.   15  IFF nested too deeply
  763.  
  764.       You have too many levels of nesting with an IFF Loop.  Try
  765.       breaking the iff loop out of a nested piece of code.
  766.  
  767.  
  768.   16  Unmatched ELSE statement
  769.  
  770.       The ELSE statement found has no opening IF or IFF command.
  771.  
  772.  
  773.   17  Unmatched ENDIFF statement
  774.  
  775.       The ENDIFF statement found has no opening IFF command.
  776.  
  777.   18  Unexpected end of file, no matching ENDTEXT
  778.  
  779.       A TEXT command was used without an ENDTEXT command and TurboBAT
  780.       read to the end of the input file before finding an ENDTEXT and
  781.       could not finish the compile.
  782.  
  783. TURBOBAT - Turbo Batch File Compiler
  784. _____________________________________________________________________
  785.  
  786.  
  787.   19  Unmatched ENDTEXT
  788.  
  789.       The ENDTEXT statement found has no opening TEXT command.
  790.  
  791.  
  792.   20  Syntax error
  793.  
  794.       Invalid command syntax was used.  Consult the TurboBAT manual
  795.       for command usage.
  796.  
  797.  
  798.   21  4DOS Specific command used
  799.  
  800.       A command was used that is normally only supported by the use of
  801.       4DOS.  If the 4DOS extension is supported internally by Turbobat
  802.       then there is no problem.  However, if any commands are used that
  803.       are not supported internally the resulting .COM file will only work
  804.       on a system running 4DOS.
  805.  
  806.   22  TurboBAT extension used
  807.  
  808.       This is notifying you that a non standard command was used
  809.       inside the batch file.  There is no problem with this usage,
  810.       except that the .BAT file might not work unless compiled with
  811.       TurboBAT.
  812.  
  813.  
  814.   23  Open REPEAT statement
  815.  
  816.       A REPEAT command was used with no UNTIL command to close it.
  817.  
  818.  
  819.   24  Open WHILE statement
  820.  
  821.       A WHILE command was used with no WEND command to close it.
  822.  
  823.  
  824.   25  Open IFF/ELSEIFF statement
  825.  
  826.       An IFF or ELSEIFF statement was used with no ENDIFF to close it.
  827.  
  828.  
  829.   26  Command not supported in this version of Turbobat
  830.  
  831.       A command was used that is not supported by TurboBAT.  Contact
  832.       Foley Hi-Tech Systems for details on solving this problem.
  833.  
  834.  
  835.   99  Internal error - please contact Foley Hi-Tech Systems
  836.  
  837.       An internal processing error has occured with TurboBAT.  Contact
  838.       Foley Hi-Tech Systems technical support.
  839.  
  840.  
  841.  
  842. TECHNICAL SUPPORT
  843. _____________________________________________________________________
  844.  
  845.  
  846.   Often we get calls from people asking questions that can be
  847.   solved easily by checking through the manual before calling tech
  848.   support. We ask that you browse the manual and look for information
  849.   pertaining to your particular problem before calling. This can often
  850.   save you time, as we take a collection of our most common questions
  851.   and try to address them in this manual.
  852.  
  853.   We offer alternative methods besides the conventional phone
  854.   support, such as a multi-line 24-hour BBS system. We also monitor
  855.   most technical conferences in the BBS Interlink and RelayNet
  856.   networks as well as many conferences on the CompuServe
  857.   Information System. You may send messages and questions via any of
  858.   these services.
  859.  
  860.   Currently our Tech Support office is staffed Monday through Friday
  861.   from 9:00 a.m. to 5:00 p.m. Pacific Time. There is a chance,
  862.   however, that someone is in the office outside this time frame.
  863.   If so, we will gladly answer your questions outside the normal
  864.   business hours.  Registered users are given unlimited technical
  865.   support.
  866.  
  867.   Foley Hi-Tech Systems
  868.   Technical Support Department
  869.   185 Berry Street
  870.   San Francisco, CA  94107
  871.   (415) 882-1730
  872.   (415) 882-1733 FAX
  873.   (415) 882-1735 BBS
  874.   PCVENB CONF. 13 CompuServe
  875.  
  876.  
  877.  
  878. CREDITS
  879. _____________________________________________________________________
  880.  
  881.  
  882.   This collection of utilities started out as a small set of home
  883.   grown tools that I just could not stand to live without.  Many times
  884.   someone would see me using them and ask for a copy.  This was a big
  885.   mistake.  All of the sudden I had to debug my code.  Someone would
  886.   call me up and remind me of some problem with a utility that I had
  887.   written or asked me to just add this one little feature.  Six years
  888.   later the package has evolved to its current state.  Along the way I
  889.   have had the help of many people in testing and ideas for products.
  890.   I would like to thank all of those people who have of course
  891.   registered these utilities as this is now a new incentive for
  892.   continuing to expand them.  More specifically I'd like to thank the
  893.   following:
  894.  
  895.   Kathy Smith
  896.   Jay Wessel
  897.   Roger Cross
  898.   Brian & Tess for Channel 1
  899.   Paul Somerson & Bantam Books
  900.   PC Tech Journal (A Great Loss)
  901.   PC Magazine
  902.   Byte Magazine
  903.   Jerry Pournelle
  904.   Association of Shareware Professionals
  905.  
  906.  
  907.  
  908.  
  909. PROGRAMMING
  910.  
  911.   The ExtraDOS Toolbox utilties use a wide variety of programming
  912.   tools including:
  913.  
  914.   Borland Turbo Pascal 7.0
  915.   Borland Turbo Assembler 3.0
  916.   Borland Turbo C++ 1.0
  917.   Borland Turbo Debugger 2.0
  918.   Turbo Power Software Object Professional 1.0
  919.   Phil Katz' PKLite Professional 1.13
  920.   Unity Programmers Editor 3.33
  921.   Ralph Browns' Interrupt List
  922.  
  923.  
  924.   Programming by:
  925.  
  926.   Mike Blaszczak
  927.   David Foley
  928.   Joe Halpin
  929.   Bill McKee
  930.   Mike Molloy
  931.   Mike Viens
  932.   Ross Wentworth
  933.   Randall Woodman
  934.  
  935.  
  936. CREDITS
  937. _____________________________________________________________________
  938.  
  939.  
  940.  
  941. ART
  942.  
  943.   Artwork for the ExtraDOS Toolbox was created using:
  944.  
  945.   Ian Davis' TheDraw 4.01
  946.   Aldus Freehand 2.0
  947.   Electronic Arts Studio/8 2.0
  948.  
  949.  
  950.   Art by:
  951.  
  952.   David Foley
  953.   Noel Gamboa
  954.   Moses Gates
  955.   Shahasp Herardian
  956.   Pat McSween
  957.   Ross Wentworth
  958.  
  959.  
  960. DOCUMENTATION
  961.  
  962.   Documentation for the ExtraDOS Toolbox was written using:
  963.  
  964.   FHTS SuperEdit 3.04
  965.   Word Perfect 5.1
  966.   MS Word for Windows 2.0
  967.   Grammatik for Windows 1.0
  968.   Aldus Pagemaker 4.0
  969.   Unity Programmers Editor 3.33
  970.  
  971.  
  972.   Documentation by:
  973.  
  974.   Mike Blaszczak
  975.   David Foley
  976.   Mike Viens
  977.   Ross Wentworth
  978.  
  979.  
  980.   Printed Manuals by:
  981.  
  982.   BindCo, Brisbane, CA.
  983.  
  984.  
  985. LICENSE INFORMATION
  986.  
  987.   CHIMES, EVAL and RAMDRIVE are derivatives of the Nifty James
  988.   utilties by Mike Blaszczak.
  989.  
  990.   FILEATTR, NAMEDIR and SWAPFILE are derivatives of the Fantastic
  991.   Utilities by Mike Viens.
  992.  
  993.  
  994.  
  995. FHTS Products
  996. _____________________________________________________________________
  997.  
  998.  
  999. Safety Disk (tm)
  1000.  
  1001.   Safety Disk saves all of your systems vital information and will
  1002.   solve most problems due to:  Loss of battery power, Loss of CMOS
  1003.   information, accidental deletion of boot files, virus damage to boot
  1004.   disk.
  1005.  
  1006.  
  1007.   "Use Safety Disk and your PC is Safe.", Computer Shopper, March 1992
  1008.  
  1009.   "Used in Conjuntion with a conventional backup utility, Safety Disk,
  1010.    for $59.95 will provide as bulletproof a backup as you're likely to
  1011.    find in the PC marketplace.", InfoWorld, February 10, 1992
  1012.  
  1013.   "Safety Disk is so deceptively easy to use that it makes hard-drive
  1014.    and computer maintenance seem impossibly easy.", PCM Magazine, May
  1015.    1992
  1016.  
  1017.   "I have discovered the most unique and useful system maintenance
  1018.    utility since Spinrite came along.", MBUG PC Newsletter, December,
  1019.    1991
  1020.  
  1021.  
  1022. ExtraDOS Toolbox (tm)
  1023.  
  1024.   A large collection of over 50 utilities that DOS forgot. Includes
  1025.   many helpful utilities that enhance MS-DOS machines. Featured in the
  1026.   DOS Power Tools, 2nd Edition, Revised for DOS 5.0 book by Bantam
  1027.   Books.
  1028.  
  1029.  
  1030. WizLabel (tm)
  1031.  
  1032.   Print Sharp Wizard phone listings directly to your SLP Printer
  1033.   without having to convert your data.
  1034.  
  1035.  
  1036. Coach Database System■.
  1037.  
  1038.   CDBS provides a method for tracking and evaluating NBA teams, NBA
  1039.   players, and college players. It supplies a comprehensive report
  1040.   generator for building decision support reports on scouted players.
  1041.  
  1042.  
  1043. FHTS Products
  1044. _____________________________________________________________________
  1045.  
  1046.  
  1047.  
  1048. Press Gate Manager■.
  1049.  
  1050.   Software for event organizers. Creates and maintains a database of
  1051.   events and guests with the ability to track seating by type,
  1052.   location, and person. Produces seating charts and labels for press
  1053.   passes.
  1054.  
  1055.  
  1056. FINDB■.
  1057.  
  1058.   Financial Database System for tracking shareholders in a company.
  1059.   Allows the instant retrieval of information based on any part of a
  1060.   persons account id, ss#, zip code etc.  Has support for completely
  1061.   customized HP Laserjet tax forms.  Ideal for generating K1 tax
  1062.   reports for limited partnerships.
  1063.  
  1064.  
  1065.  
  1066. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  1067. _____________________________________________________________________
  1068.  
  1069.  
  1070. We are constantly adding new utilities to the ExtraDOS Toolbox
  1071. collection.  Some are developments of ideas from our customers.  If
  1072. you know of a utility that you would find handy or updates to
  1073. existing utilities please let us know about them.
  1074.  
  1075.  
  1076. BATPLUS     Collection of enhancements for DOS Batch files.  BATPLUS
  1077.             enhancements will also be supported by TurboBAT.
  1078.  
  1079. BOOTMGR     Boot Manager will allow you to choose from many different
  1080.             boot up configurations by displaying a menu of choices
  1081.             at boot time.  Each configuration can have a seperate
  1082.             AUTOEXEC.BAT and CONFIG.SYS associated with it.
  1083.  
  1084. DIALIT      Small TSR that allows you to pop up over any text screen
  1085.             and capture a phone number and then dialing with your
  1086.             modem.
  1087.  
  1088. DIFF        Full screen file comparison utility.  Will display the
  1089.             differences between two different files.
  1090.  
  1091. DIRSORT     Sort directories by Name, Extension, Date, Time or Size.
  1092.  
  1093. DISKTEST    Command line utility to perform testing functions on disk
  1094.             drives looking for bad sectors or clusters.
  1095.  
  1096. EMSX86      EMS 4.0 Memory Manager that converts Extended Memory into
  1097.             LIM EMS 4.0 Expanded memory.
  1098.  
  1099. FKEYSET     Allows you to assign customized values for all the function
  1100.             keys.
  1101.  
  1102. LQPRINT     Allows 9 pin dot matrix printers to print near letter
  1103.             quality output by converting text into high resolution
  1104.             graphics.
  1105.  
  1106. NBSTIME     Will set your PC clock to National Atomic Clock time by
  1107.             calling NBS with your modem.
  1108.  
  1109. PRMPTMGR    Prompt Manager gives you access to a library of DOS prompts
  1110.             and allows you to create your own DOS prompts.
  1111.  
  1112. PRINTCTL    Print Controller is a multiple printer spool and configuration
  1113.             utility.  Supports EMS or DISK spooling and up to three
  1114.             printer ports.
  1115.  
  1116.  
  1117. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  1118. _____________________________________________________________________
  1119.  
  1120.  
  1121. SORT        Advanced SORT utilty for DOS.  Features many enhancements o
  1122.             over the DOS version.
  1123.  
  1124. SPEEDFL     Increase access to some floppy disk drives.
  1125.  
  1126. SPLITFL     Split files into multiples for modem or diskette transfers.
  1127.  
  1128. STOPWTCH    Stop Watch allows you to time programs at the DOS prompt.
  1129.  
  1130. SWAPFILE    Swap to file names with the associated files.
  1131.  
  1132. XCD         Smart CHDIR command.  Will accept partial names.
  1133.  
  1134. XDEL        Advanced delete command.  Allows many options and exclusions.
  1135.  
  1136. XDIR        Updated DIR command with sort options.
  1137.  
  1138. ZIPCODE     TSR to allow the searching of US Postal Zip Code Database.
  1139.  
  1140.  
  1141.  
  1142.  
  1143.   The latest versions of the ExtraDOS Toolbox utilities can be found on:
  1144.  
  1145.   FHTS PC GURU III BBS, San Francisco, CA  (415) 882-1735
  1146.  
  1147.   CHANNEL 1 BBS, Cambridge, MA             (617) 354-8873
  1148.  
  1149.   COMPUSERVE INFORMATION SERVICE           PCVENB CONF. 13
  1150.  
  1151.